Enriching software architecture documentation

Enriching software architecture documentation

The effective documentation of Architectural Knowledge (AK) is one of the key factors in leveraging the paradigm shift toward sharing and reusing AK. However, current documentation approaches have severe shortcomings in capturing the knowledge of large and complex systems and subsequently facilitating its usage. In this paper, we propose to tackle this problem through the enrichment of traditio...

Software Architecture Documentation for Developers: A Survey

Software Architecture Documentation A cognitive perspective

How do software developers comprehend software architectures? The main question addresses several aspects inherent to software development and this research aims to reveal the effects of the behaviour displayed by developers and subsequently provide ideas for future directions in research. Experiments were conducted using the Think Out Loud method to gain insight into the developers’ minds. Exp...

Understanding Software Architectures: Tracing architectural knowledge in software architecture documentation

Introduction " The reality is more excellent than the report. " – Ralph Waldo Emerson This thesis is about understanding software architecture documentation and how the integration of software architecture description and rationale can improve this understanding. Understanding software architecture (documentation) is important in the complete life cycle of a software architecture; during develo...

An exploratory study on ontology engineering for software architecture documentation

Architectural Knowledge (AK) can be retrieved by the stakeholders in a software project. Recent findings show that the use of ontology-based SA documentation is promising. However, different roles in software development have different needs for AK, and building an ontology to suit these needs is challenging. In this paper we describe an approach to build an ontology for SA documentation. This ...